home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 2 / Amiga Tools 2.iso / tex / macros / source / base / pastex.txt < prev    next >
Text File  |  1995-03-15  |  7KB  |  187 lines
  1.  
  2.               LaTeX installation instructions for PasTeX
  3.  
  4.                            31. August 1994
  5.  
  6.  
  7. SUMMARY
  8. =======
  9.  
  10. This file contains instructions on how to install LaTeX for 
  11. PasTeX on the Amiga.  Before reading this file, you should read
  12. install.txt, which will explain how the LaTeX installation works.
  13.  
  14. This file describes:
  15.  
  16.  * How to save any old version of LaTeX.
  17.  
  18.  * How to configure LaTeX.
  19.    (You can skip this part if you`re new to this.)
  20.  
  21.  * How to unpack the LaTeX distribution.
  22.  
  23.  * How to create the LaTeX format.
  24.  
  25.  * How to install the LaTeX files.
  26.  
  27.  * What to do if you have any problems.
  28.  
  29.  
  30.  
  31. PRELIMINARIES
  32. =============
  33.  
  34. Most of the installation procedure is concerned with creating a so
  35. called format file. This file contains essentially all the macros
  36. that make up the LaTeX package in a format that can be read in very
  37. quickly by virtex.
  38.  
  39. This guide assumes that you have an unmodified installation of PasTeX
  40. release 1.3 or higher. If you have made any changes you should be able
  41. to figure out yourself where to deviate from this introduction.
  42.  
  43. First of all move all of the files that accompanied this document to
  44. a directory that should be outside the TeX: hierarchy. DO NOT copy
  45. them directly to TeX:macros! Most of the installation will take place 
  46. in this directory. If the installation was successful you can delete 
  47. this directory afterwards.
  48.  
  49.  
  50. SAVING ANY OLD VERSION OF LaTeX
  51. ===============================
  52.  
  53. If you are currently using the old LaTeX version, 2.09, you may wish
  54. to save it before installing the new version of LaTeX.
  55.  
  56. The format file is located in the directory TeX:formats and is named
  57. something like lplain.fmt or latex.fmt. If the name is latex.fmt you
  58. should rename it to latex209.fmt. This installation procedure will
  59. create a new file called latex.fmt that would overwrite the old one.
  60.  
  61. Now you should save your old style files. Make a subdirectory latex209
  62. in the directory TeX:macros and copy all files #?.sty from TeX:macros 
  63. into this directory.
  64.  
  65. If you want use LaTeX 2.09 again for some reason, set the environment
  66. variable TEXINPUTS with something like
  67.  
  68. setenv TEXINPUTS .,TeX:macros/latex209,TeX:macros
  69.  
  70. Make sure that TeX:macros/latex209 comes before TeX:macros so that
  71. the old style files are used. (The "." refers to the current directory.
  72. If you omit it, files in the current directory will not be found!)
  73. Then call LaTeX with "virtex &latex209" (or "virtex &lplain", if that
  74. was the name of the old format file).
  75.  
  76.  
  77. CONFIGURING LATEX
  78. =================
  79.  
  80. If you have PasTeX release 1.3, you may wish to edit the file
  81. texsys.cfg to have LaTeX work around some quirks in the version
  82. of virtex that comes with it. First find out the actual version
  83. of virtex with the command "version TeX:bin/virtex".
  84. Then edit the file texsys.cfg and insert a line right at the top
  85. containing
  86.  
  87. \def\@TeXversion{3.14}
  88.  
  89. and, of course, insert your actual version number if it differs.
  90. This change is however purely cosmetical and only affects the
  91. format of warning messages.
  92.  
  93.  
  94. If at some point TeX runs out of memory it will stop with an error message.
  95. You can try and make more memory available to TeX by editing the file
  96. TeX:config/tex.cnf. Try to figure out which parameter might have caused
  97. TeX to run out of memory. If the error message said e.g
  98. "Font <foobar> not loaded: Not enough room left", you should look at
  99. the parameter fontmax and/or fontmemsize. A good place to start is
  100. always the pair memmax and memtop. Read the comment in the file for more
  101. information.
  102.  
  103. >From TeX version 3.0 you have the possibility to have more than one
  104. set of hyphenation atterns available in a format file.  See the file
  105. texpert.txt for more details of how this can be achieved.
  106.  
  107.  
  108. UNPACKING THE DISTRIBUTION
  109. ==========================
  110.  
  111. Cd to the directory that contains the distribution files. Check if 
  112. there is a file called "latex.ltx". If there is you probably have 
  113. got a distribution that already has been unpacked and can skip this 
  114. part. If there is a problem with a missing file at some point during
  115. the installation, try unpacking it again anyway.
  116.  
  117. If latex.ltx does not exist, the command "initex unpack.ins" will
  118. unpack the distribution. If you have an 68000 based Amiga, now is 
  119. the time to go and make some coffee.
  120.  
  121.  
  122. CREATING THE LaTeX FORMAT
  123. =========================
  124.  
  125. When the unpacking procedure is complete type "initex latex.ltx".
  126. This will create the format file. When this is finished, copy it to
  127. TeX:formats. Make sure you do not overwrite an old latex.fmt,
  128. especially if there have been any problems.
  129.  
  130.  
  131. PUTTING THE FILES WHERE LaTeX CAN READ THEM
  132. ===========================================
  133.  
  134. Now you need to install the new style files and everything else LaTeX
  135. needs. Copy the following files to TeX:macros:
  136.  
  137.       latexbug.tex testpage.tex docstrip.tex lablst.tex 
  138.       idx.tex nfssfont.tex small2e.tex sample2e.tex
  139.       #?.cls #?.clo #?.sty #?.fd #?.def #?.cfg
  140.       
  141. If you have MakeIndex installed, copy #?.ist to the MakeIndex inputs 
  142. directory.
  143.  
  144.  
  145. CHECKING THAT THE INSTALLATION WORKED
  146. =====================================
  147.  
  148. Now you can check if the installation worked. First cd to another
  149. directory that does not contain any of the distribution files.
  150. Copy the file ltxcheck.tex here and type "virtex &latex ltxcheck"
  151. to the shell prompt. TeX will report that it cannot find a syntax 
  152. for the current directory, but that is OK. (If you figure out a way
  153. to refer to the current directory, like UNIX ./, please tell us.)
  154.  
  155. It will then check if it can find the file article.cls in the current
  156. directory and issue an error because it will find the file in
  157. TeX:macros. This is actually a good sign. Simply press return to the
  158. question mark. 
  159.  
  160. It will then check for the version of TeX currently installed. If 
  161. you have PasTeX release 1.3, which contained virtex version 3.14, 
  162. there will probably be some ^^Js cluttering up the output.
  163.  
  164. You can edit texsys.cfg (in the distribution directory) and rebuild
  165. the format file as suggested by the warning text (see the section on
  166. configuring LaTeX). Or you can simply ignore this and tolerate the 
  167. strange warning messages until you can get PasTeX release 1.4, which 
  168. is currently in the late beta testing stage and should be publicly 
  169. released soon. If you feel up to it, get the beta release now.
  170. It is available as pt14b6.lha in the directory text/tex on aminet.
  171.  
  172.  
  173. PROBLEMS
  174. ========
  175.  
  176. If there is any problem during installation, read the section on
  177. configuring LaTeX in this document. Some of the problems that may
  178. occur are covered there. Carefully reread the rest of the document,
  179. then read the document install.txt, especially the `PROBLEMS' section.
  180.  
  181. If none of these can solve your problem, try to get some human help.
  182.  
  183. --- Copyright 1994 Christian Bauernfeind and the LaTeX3 project ---
  184. ---                     All rights reserved.                    ---
  185.  
  186.  
  187.